BAY AREA 


USERS GROUP 
NEWSLETTER tsen 








August 1981 














SUDSCripricn *till 
year end $8.00 


More Machine Language 
Paul Conrad 


\ A few issues ago I gave you a little bit of 
‘information about using machine language 
routines with your BASIC programs. A lot 
of people have been asking for more, sa 
let's cover a couple of the next items to 
be considered when preparing these 
routines, 


Let’s first look at some of the storage 
locations which may be used by our 
routines; and then at how our machine 
language code might begin, 


There are two kinds of storage locations 
which are important to you. One of these 
is the location where your code will be 
stored. This may be in a string in your 
program or somewhere else in storage, 
The most likely places to stick your 
program are in page é, which starts at 
location 1536, or in free storage just 
below your graphics display list area. The 
second type of storage you are especially 
interested in is page 0 storage. These are 
storage locations from zero to Z55. These 
are important because there are special 
machine language instructions which use 
page 0 locations, together with the X&Y 
registers for quick and easy addressing of 
storage: | : 


ATARI 800, 48k - $599; 810 
disk drive, 2 wks old - $415; 
850 Interface, 2 wks old - 
$125 (both still under 
warranty). Call 408- 241- 
0398 nights. : 





Single Copy Price $1.00 


Part of page 0 is reserved for the 


operating system and documented in the 


Atari hardware and operating system 
manuals, Most of the rest of page zero is 
turned over to BASIC for its use, 
Unfortunately, storage maps of how BASIC 
uses page zero have not been made 
available. Positions Ziz and ž13 are 
where your routine should place a value 
that is to go back to your BASIC program, 
If you invoked the program with a 
statement like X = USR(1536,A), then The 
contents of 212 + 713#256 will be placed 
into X at the end of the routine. — ae; 


I have found that using positions 
703-2704,2707-208, and 209 do not seem to 
upset BASIC. However, I have not written 
any code that expects these values to 
remain useable between uses of the 
machine code. If anyone out there can 
come up with better info on the use of 
page zero please let me know, 


Most machine language programs will start 
with a series of instructions like the 
Following: | 


FLA 

FLA 

STA EUA 
FLA- 

STA AUS 
FiA 
OTF 708 
PLA 

STA “UF 


Let’s take a look at what is going on is 
those instructions. The first PLA pulls 
from the stack the top value. That value 
is the number of parameters or values 
which have been placed into the stack 
after itself. In this example two values 
are later pulled out, one byte at a time. 
continued on page 7... 
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COMPUTERTOWN by Liza Loop 


What is ComputerTown? Computer iown 


is people teaching people to 
become informed citizens of 
today's information society. It 
is kids developing an intuitive 
understanding of computer 
technology through recreational 
games and educational simulations 
running on microcomputers. It is 
adults sharing their knowledge of 
computer tools with their 
neighbors. Computerfown is an 
chance for everyone in town to 
become "Computer Literate". 


Where is ComputerTown? 
ComputerTown is in your town, at 
the library, the recreation. 
center, the park, and the Senior 
Center. It is a grassroots 
phenomenon which grows out of your 
community's need to keep up with 
the technology of the 20th 
century. It is "informal 
education". You set up a computer 
where people can touch it and ask 
questions and ComputerTown is 
there. 


Who runs ComputerTJown? You do. It 
takes all kinds to run a town - 
people who can organize and 
administer, people to pick up the 
mess after the crowd has gone 
home, technical experts, fund- 
raisers, playground monitors. You 
don't have to know how to program 
a computer to be a big wheel in 
ComputerTown, you just have to 
want to contribute to making 
yourself and your neighbors more 
comfortable with computer 
technology. 


Are there any Computerfowns yet? 
Yes. Several, and each one is 
different. ComputerTown - “enlo 
Park, centered in the public 
library, has been helping kids and 
grownups become computer literate 
Since 1979. There is a 
ComputerTown in Oregon, one in 
Oklahoma, several in the United 
Kingdom, and many projects around 
the United States which share the 
spirit, if not the name, of 
Computer Town. 


But what about ComputerTown USA! 
At the present time, ComputerTown 
USA! is a nationwide dissemination 
project funded by the National 
Science Foundation. 
help new, local ComputerTowns 
Start by providing support in 
three forms: a periodical called 
ComputertTown, USA! News Bulletin; 
an "Implementation Package" 
containing information on how to 
start and manage a successfull 
ComputerTown; and a series of 
outlines for self- teaching 
courses appropriate for use in 
ComputerTowns. You can subscribe 
to the News Bulletin by writing to 
ComputerTvTown USA!, Box E, Menlo 
Park, CA 94025. 


Is there a role for ComputerTown 
USA! in the future? The National 
Science Foundation grant funds 
will end in September, 1983. But 
local ComputerTowns may want to 
form a national and perhaps a 
global association to continue to 
serve as a communication link 
between local projects. Please 


write for more information. 
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Ý ADVERTIZING POLICY 









Short ads (3 to 5 lines) will be run 
FREE for INDIVIDUALS with PAID 
memberships. 







Commercial Ads will run upon 
receipt of camera-ready copy and 

payment according to the fee schedule 
below: 









Full page (8 1/2" x 11") $50 
Half page $25 
Quarter page or less $12.50 


Copy deadline -the 7th of each month 
Mail to: Newsletter Ads 

BAY AREA ATARI USERS GROUP 

c/o Foothill Coplege 

Los Altos Hills, Ca 94022 

or phone Liza 415-858-2034 
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s Interim =... 
Bring this ad in during the month of 


AUGUST 
for special low prices to BAAUG members 


810 Disk Drive_____________ $480- SOFTWARE 
825 Printer ss -eierne $634- VISICALC 164.- 
850 Interface -=> ee 147= Smart Terminal 

Emulator Prog. 12-7 
D-CAT Modem... 25... 175" 

Telelink 19. - 
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d 
Come by and check our i interim electronics 
: : 447 So. Bascom Ave. S.J. 

regularly low prices..... gz- idok i 











SOFTWARE REVIEW 


by 
Dave Flory 


Before I progress into the reviews 
I want to say that the opinions expres- 
sed here are mine and noone else's so 
if I get someone mad, get mad at just 
me. 


I recently purchased "CONFLICT 
2500" by Avalon Hill @ a discounted $11 
price. Even at that price I consider it 
a rip-off. If you are a board wargame 
nut you might enjoy it as you will be 
used to sessions that take many minutes 
between moves, but as á computer game 
nut I find any game that takes as long 
as this one to make a move terminally 
boring. The only program which I have 
that is slower is Dynacomp's VALDEZ 
tanker simulation (more on that later). 
The games advertising is excellent but 
the "graphics" are practically nonexis- 
tent and make no use of Atari capabil- 
ity. Commands are cumbersome and poor- 
explained and the enemy you are fight- 
is usually invisible, which makes 
strategy difficult. I might be willing 
to půt up with the rest- 1f-it- weren't 
so infernally slow. If anyone wants to 
see the game without buying contact me 
and I'll give it to you. I haven't even 
backed it: up. 


More on the. other slow program. I 
found it interesting inspite of its 
very. slow operation because I am inter- 
ested in boats and the ocean and was 
fascinated to see how cumbersome and 
massive the oil tanker really is. It 
takes around 10 miles and 30 minutes of 
time to stop it from a speed..of 18 
knots at maximum reverse power. If you 
are over on the sea near a Farce‘ tanker 
such.as is simulated.in VALDEZ stay the 
mech OUI- OF ITS WAY. It was somewhat 
interesting-to mento try- -and steer this 
behemoth in and -out .of some of the-fiord 
ön the coastline. I will admit that it 
is extremely frustrating to spend.45, min 


of actual time navigating the simulation 


niru. the Valdez Strait only to crash 
another tanker and sink. Still a better 
value than the other contender for 'slow 
Champ’. 


i Now some software I can say some 
gool thilgs about, In general the stuff 
from Adventure International is fine 
material, It is common knowledge and is 
acknowledged by AI that there are hard 
times in store for people loading the 
adventures from cassette. It can be 
nothing short of maddening to have the 
tape load for 19 minutes before giving 
an error and "bombing" but even with 
this difficulty I have found the 
"Adventure" programs by Scott Adams to 
be entertaining and worth the price in 
entertainment value. If you do manage © 
to load one on disk then they're a joy. 
I have only three and the last one load- 
ed the first try. Other programs by 

AI that I have used are "Mountain 
Shoot”, 4 "Deflection, F "Goli". At 
first look thesé might seem rather 
trivial but they are all implemented 
well and all three seem dangerously 
addictive if you start playing them, 
"Deflection" in particular has very 
strong addictive quality. 


Venturing into a more sophisticated 
area, QS Forth, even as :a complete nol- 


‘ice an the arga, 1 can see that It isa 


very powerful programming tool. We've. 
had several presentations on FORTH by © 
different people at group meetings but 
I am sure that some of us had the same 
feeling I had, "well sure he's showing 
us some great things, but he's an | 
expert, I.could never do that stuff," 
I can't do it yet- eithen but I can see 
that I will De anle (9 vith some. Praci 
tice and not so far in the future : 
either. The documentation provided in 
the QS FORTH package is so superior to 
the documentation of most software I've 
purchased as to put it in completely 
separate class, The only programs I've 
seen that- begin to mateh it in this L 
area are the IRIDIS packages which have 
been reviewed in all the magazines and 
the Seebree's 3D graphics package, This 
later has some problems but the listing 
of programs that come with it is quite 
educational in many areas. Another 
program package which has complete list- 
ing of the programs with some good sub- 
routines is the "Atari Safari" package. 
The Iridis programs are the only ones 
to. come close-to the FORTH package in 
completeness of documentation as they 
include«"hacker" tips and stuff that 
really isn't imo the programy just is 
interesting and useful to users, 





SOFTWARE 


NEW - SUPER SOFTWARE! 


RPN CALCULATOR SIMULATOR 
by John Crane 
(16K Tape/Disk) $19.95/$22.95 
THIS IS A TUTORIAL 
THAT HAS YET TO BE BEAT ! 
Emulates the functions of an *HP-RPN 
Scientific Calculator and displays the 
registers as the operations take place. 
Program shows the stack, status of the 
20 memory registers, commands, and the 
input. System commands, Stack oper- 
ations, Math and Stat Functions are 
implemented. 


PERSONAL QUICK EDITOR 
AVATAR STAFF 
(32K Disk) $24.95 

THIS IS A REAL WINNER! 
written in BASIC and MACHINE LANGUAGE 
code, this program can input, change, 
print, format, save and retrieve text 
data. The program scrolls the text 
forward or reverse, finds and allows for 
insertions and deletions of text. Text 
can easily be formatted during initia! 


input or after it has been saved on` 


disk. 


ZOGAR 
by Pasquale Barratta 
(16K Tape/Disk) $9.95/$12.95 
A fast paced action game. As Corporal 
in the National Space Guard, you must 
search throughout the galaxy for fhe 
dreaded, dangerous Zogar, who has es- 
caped. You must bring him back alive! 


HOME MANAGER 
by Jerry Falkenhan 
(32K RAM Disk) $50.00 
Home Manager is a series of programs 
which cover cash flow, budget, filing, 
inventory and gas consumption. 


You don't have to be a computer program- 
mer to use this package! The computer 
does the work for you. Along the way, 
your choices and inputs are monitored by 
the program to insure that only correct 
data is being used and saved. 


Cash Flow has been tested for over six 
months with non-computer oriented 
people. The result is a nice, smooth- 
running package that makes using the 
computer an enjoyable experience with 
useable, practical applications. The 
program allows you to input up to 200 
entries per month as both income and 
expense, in category names that can be 
used as is, or modified to suit your 
needs. Categories can be viewed on the 
screen or can be printed. 


Cash Flow is a total package in itself, 
and is also a module that fits into the 
HOME MANAGER package. As these modules 
become available, they can be purchased 
and put into the binder indexes that are 
already provided. You can tailor our 
package to your own persomal needs. 
CASH FLOW comes in a handsome, 3-ring 
binder with documentation. 


KKK KKK 


if some of these names took familiar, you're right! We're a new 
company with advertising already established in COMPUTE (June 
- August) and A.N.A.L.O.G. (July/August). If you're a software 
programmer with innovative ideas and would like to become an 
author with AVATAR, call or write for information for our terms 
and software agreement. 


Mail Check or Money Order 


Ca. residents add 6 1/2 % tax 


WRITE FOR COMPLETE CATALOG OF 
new and upcoming products from = 
AVATAR SOFTWARE 


NEW LOCATION ! 
2096-A Walsh Ave. Santa Clara, Ca. 


408-988-5399 




















NATIONAL PERSONAL COMPUTING GROUP 


SIGPC (the Special Interest Group on Personal Computing of the 
Association for Computing Machinery ) is an "open membership" educational 
society of people interested in PERSONAL COMPUTING. "Open membership" means 
anyone is welcome to join -- including computer hobbyists whom noone could 
possibly consider "professional" (even after they get rich). Of course, there 
are also a few true "computing professionals" among the ranks. 


SIGPC is one of many Special Interest Groups within the Association for 
Computing Machinery. At last count there were 32 SIGs with a total of 92,283 
memberships (fewer members because many people belong to more than one SIG). 
Each SIG is a national organization with many similarities to SIGPC. Since 
there is a lot of overlap of interests, some PCers will want to explore topics 
with members of other SIGs, SIG Programming Languages (SIGPLAN), Computers and 
Society (SIGCAS), and Office Automation (SIGOA) to name a few. This is 
fertile ground for co- sponsored meetings and publications. 


SIGPC is a volunteer organization and it does only what its members make 
it do. It is a relatively new group which has just begun to be active. SIGs, 
in general, often sponsor activities such as: CONFERENCES and TECHNICAL 
MEETINGS, PROFESSIONAL DEVELOPMENT SEMINARS, PUBLICATIONS, TECHNICAL 
COMMITTEES, STANDARDS COMMITTEES. 


More on ACM, SIGPC, and the Penninsula Chapter in future issues... 
MACHINE LANGUAGE 


continued from page 1... 
So, if we wanted to be sure the right 
number of values was in the stack we could 
compare the first pulled value to Zz. . 


The next PLA pulls the high order byte of 
the next parameter. This value times 256 
is part of the total value of the first 
parameter. We store it in the highest 
number location of two consecutive 
storage positions which will hold the 
entire value. We do this because many of 
the instructions access storage positions 
which are addressess of storage locations 
and expect the least significant portion is 
in the low numbered location and the most 
significant part, the #254 part, is in the 
higher numbered location. Does that make 
any sense? | 


= World Class 


Your ATARI is a world class personal computer. But you 
need great software in order to exploit its capabilities. 
And you need information about how it all works. 






















IRIDIS is a series of software packages that will help you 
enjoy and understand your ATARI more fully. The 
programs are outstanding, just as you would expect from 
the people who have published 23 issues of the widely 
acclaimed CURSOR Magazine for the Pet since 1978. But 
IRIDIS is more than just a collection of excellent 
programs. IRIDIS #2 comes with a 56-page manual that 
has clear, detailed explanations of how each program 
works. The explanations tell you line-by-line what each 
program does, and how it does it. 

I’ll plow on anyway! We continue PLA‘ing 
and STA‘ing the values until we have 
os Se ee ee gotten all the parameters out of the stack 
and saved them in some storage location 
for later use by our routine. You may well 
want to use locations 712 & Z13 as active 
locations and when the routine finishes 
eee Ee oe ee ee eS : just leave them as the answer going back 


Published By tHECODE a (m, 
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IRIDIS and your ATARI: A winning team. World Class! 


IRIDIS #2-Fondedit and Knotwork programs. 
Includes 56 page User Manual. 
$15.95 Cassette, $18.95 disk. 

Mastercharge and Visa welcome. 


Goleta, CA 93116 


805-683-1585 I hope this helps nudge you a little 


further down the M.L. road. In future 
articles, if I ever get them written, I’ll 
talk about flags, addressing modes, and 
many of the instructions in the 6502 set. 


So long for now. | 
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Suey MAREJ 








CRIS CRAWFORD RETURNS. 


Our favorite Display List 
Demystifier will treat us to 
over an hour of enlightenment 
complete with notes on how to 
make our screens sparkle and 
scroll. : 


August 3rd 7 pm 
Foothill College Campus 
Center Lounge 

12345 El Monte 

Los Altos Hills, CA 


Meet in SAN JOSE on TUESDAY 


Questions and Answers, as 
usual, on Tues. Aug. 18 


Interim Electronics, 447 5. 
Bascom Ave, San Jose, CA. 
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Group Member Offers Service 


Hans Hansen will provide two 
diskette services to BAAUG 
members. Fast formatting will 
increase loading speed for any 
program stored under any Atari 
DOS. Diskette retrieval will | 
fix diskettes which were saved 
before your drive speed was 


readjusted. Bring the problem 


diskette and a blank diskette to 
a meeting and Hans will take 
them home, fix them up and 
return them next meeting. 
(Handling fee =- $.50) If you 
prefer mail service the fee will 
be $1.00. Hans says he won't 
make any profit but that he 
hopes fees will cover his 
expenses for the services. You 
may call him evenings between 7 
and 10 pm for further details. 


415-490-0175. 














